home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / cenvid / readme.doc < prev    next >
Text File  |  1995-10-17  |  29KB  |  564 lines
  1.                          CEnvi Demo - ReadMe
  2.                    
  3.                           CEnvi version 2.10
  4.                             17 October 1995
  5.  
  6.                  Copyright 1993, Nombas, All Rights Reserved.
  7.           Published by Nombas, 64 Salem Street, MEDFORD MA 02155 USA
  8.           
  9.                           VOICE (617) 391-6595
  10.                           BBS   (617) 391-3718
  11.                           FAX   (617) 391-3842
  12.  
  13.          Thank you for trying this shareware version of CEnvi from Nombas.
  14.  
  15.                           _______
  16.                      ____|__     |                (R)
  17.                   --|       |    |-------------------
  18.                     |   ____|__  |  Association of
  19.                     |  |       |_|  Shareware
  20.                     |__|   o   |    Professionals
  21.                   -----|   |   |---------------------
  22.                        |___|___|    MEMBER
  23.  
  24.  
  25. Introduction to Cmm and CEnvi
  26.  
  27.      Cmm: Cmm (C minus minus) is a scripting (i.e. programming)
  28.           language.  Cmm is 'C' for the rest of us; i.e., C minus the
  29.           hard stuff. Cmm packs the functionality of C, but eliminates
  30.           C's complex, time consuming, and hazardous data manipulations.
  31.           Cmm is immediately familiar and immediately useful to hundreds
  32.           of thousands of professional C programmers. At the same time,
  33.           Cmm is also easy to learn and use for people who have never
  34.           programmed.
  35.  
  36.           Cmm extends the power of C down to the macro language domain.
  37.           Nowhere will you find a more straight forward syntax, fewer
  38.           keywords, and such simple, well-defined rules as in the Cmm
  39.           language. Three features -- power, safety, and simplicity --
  40.           make the Cmm Toolkit the perfect fit for scripting and macro
  41.           usage.
  42.  
  43.           Cmm strengths
  44.            * Easy to learn for new programmers
  45.            * Safe (Hard to make dangerous beginner mistakes)
  46.            * Intuitive to professional C/C++ developers
  47.            * Natural extension of the C/C++ programming languages
  48.  
  49.    CEnvi: CEnvi is a standalone interpreter for the Cmm scripting
  50.           language--a powerful and versatile cross-platform macro language
  51.           interpreter.  CEnvi gives you a full strength computer language,
  52.           but without the time, system, and resource programming hassles
  53.           normally associated with developing computer programs.
  54.  
  55.           Whether you are a professional programmer, systems administrator,
  56.           experienced user, or just a novice, you can unleash the power of
  57.           your PC with CEnvi.  CEnvi can be incorporated at a pace that is
  58.           comfortable to you: you may only want to use CEnvi code set up by
  59.           a more experienced user, you may want to enhance existing batch
  60.           files with a line or two of CEnvi code, or you may want to write
  61.           complete utilities using CEnvi.
  62.  
  63.           CEnvi s automation development tools enable you to create robust
  64.           utilities, quickly build programs, and easily automate tasks so
  65.           you can work more productively and efficiently.
  66.  
  67.           CEnvi's advantages
  68.            * Easy to use
  69.            * Powerful - Allows for direct system and DLL calls
  70.            * Provides a Windows command line and programming interface
  71.            * Data Exchange through DDE, clipboard, shared memory and pipes
  72.            * Low memory and Disk usage
  73.            * Event Scheduling and Monitoring
  74.            * Enhances Existing batch and REXX utilities
  75.  
  76.           Who benefits from CEnvi
  77.            * Programming Professionals
  78.            * Network and System Administrators
  79.            * The home or business PC user
  80.  
  81.           To learn how to write scripts in the Cmm language, new programmers
  82.           should consult Chapter 2, "The Cmm Language", and Chapter 3,
  83.           "Tutorial - CmmEdit a Simple Editor".  Current C programmers
  84.           should consult Chapter 4, "Cmm vs. C", on the differences between
  85.           C and Cmm. 
  86.  
  87. What they said about CEnvi version 1.009
  88.  
  89.           "Every now and then a programming tool serves a particular need
  90.            better than anything else.  CEnvi, a shareware product from
  91.            Nombas, is such a tool. ...CEnvi has virtually replaced ReXX
  92.            and the DOS batch language in my office."
  93.                       Al Stevens, Dr.Dobb's, December '94
  94.  
  95.           "Concise documentation, an extensive code library, over 70
  96.            examples, and compact executable size make CEnvi a good choice
  97.            for writing small programs and Windows scripts." <four stars>
  98.                      Ziff-Davis Interactive
  99.  
  100.           "...if you are a C programmer, this product is really a dream
  101.            come true."
  102.                       Brian Proffit, OS/2 Magazine January '94
  103.  
  104. ... and awarded to CEnvi version 2.10
  105.  
  106.           1995 Ziff-Davis Shareware Awards - Winner of PC Magazine 
  107.           Shareware-of-the-Year award for Programming Tools
  108.  
  109. New Features in Version 2.10
  110.  
  111.    CEnvi versions have been added for Windows NT--console and GUI
  112.    mode.  Full clipboard support for Windows and Windows NT version.
  113.    This includes marking, copying, and pasting from/to the CEnvi screen.
  114.    The CEnvi shell has been greatly enhanced in all versions--including
  115.    launching applications with environment-variable inheritance, file
  116.    redirection and piping, alias, history, and many internal commands.
  117.    New "literal strings" protect text from overwriting.
  118.  
  119. -------------------------- Quick Start For DOS -----------------------------
  120.  
  121.           Create a directory to install CEnvi for DOS in (we recommend
  122.           CENVIDOS). UNZIP cenvidos.zip into the directory you created. CEnvi 
  123.           for DOS includes two executables. CEnvid.exe is a regular DOS
  124.           program. CEnvid32.exe is a 32 bit DOS version. It is useful if you
  125.           find that the regular DOS version of CEnvi is running out of
  126.           memory.
  127.           
  128.           The first time you run CEnvi for DOS, run the install.cmm 
  129.           installation script. The installation script does 2 things for you.
  130.           It creates a CMMPATH environment variable, adds the CEnvi for DOS
  131.           path to the DOS PATH.
  132.           
  133.           After CEnvi for DOS is installed, try the following sample
  134.           utilities. They best demonstrate the power of CEnvi for DOS.
  135.           Samples that end in .bat can be run as batch files. Samples that
  136.           end in .CMM require typing "cenvid sample.cmm" where sample is the 
  137.           name of the utility.
  138.  
  139.           NOTE: CEnvi for DOS can directly alter DOS environment variables.
  140.           For example, from the DOS command line enter the commands:
  141.              SET COUNT=100
  142.              CEnviD COUNT = COUNT + 2
  143.              SET
  144.           and you'll see that CEnvi has increased the COUNT environment
  145.           variable to 102.  Because CEnvi uses environment space, you
  146.           may sometimes see an error message such as:
  147.              "The environment is not big enough..."
  148.           To correct this problem, you can specify a larger environment
  149.           size with a command such as:
  150.              COMMAND.COM /E:2000
  151.           To make this change permanent, add the /E:XXXX parameter,
  152.           where XXXX is a new environment size, to the "SHELL="
  153.           line in CONFIG.SYS.
  154.           
  155.    DOS Quick-Start Sample Files
  156.  
  157.             *EnviAsks.bat: Many examples of user input using EnviAsk.bat
  158.                            and GetUKey.cmm
  159.             *EnvSort.bat:  Sort environment variables alphabetically
  160.             *FileFind.bat: Wildcard search for files on current drive or on
  161.                            all drives
  162.             *GetUKey.cmm:  Display a choice prompt and then set an
  163.                            environment variable based on user's selection
  164.             *KbdBuf.bat:   Alter the size of the keyboard buffer
  165.             *KeyState.bat: Get or set the state of the NumLock, CapsLock,
  166.                            or Insert keys
  167.             *Mouse.bat: